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1.0  INTRODUCTION 


V 

The  Naval  Ocean  Systems  Center  (NOSC)  initiated  Cronus  research  with  Release  1.0  in  1987 
(Sullivan  and  Anderson,  1988).  Cronus,  a  distributed  computing  environment  designed  specifically  for 
a  command  and  control  environment,  was  developed  for  Rome  Air  Development  Center  (RADC)  and 
NOSC  by  BBN  Systems  and  Technologies  Corporation.  Cronus  operates  on  a  variety  of  different 
hardwares  and  runs  at  the  user  level  above  the  host’s  native  operating  system  (Berets  and  Sands, 
1989).  The  Distributed  Operating  System  Experiment  (DOSE)  Version  4.0  application  was  designed 
and  implemented  by  NOSC  to  exercise  and  observe  the  facilities  provided  by  Cronus.  DOSE 
application  demonstrates  the  ability  to  map  a  Navy  application  onto  a  distributed  system.  This  docu¬ 
ment  describes  the  functionalities  and  capabilities  of  each  component  of  the  unclassified  version  of  the 
DOSE  application.  The  document  also  provides  instructions  on  how  to  run  the  application  in  the 
Cronus  environment  (Release  1.3  or  newer  release)  and  recommended  testbed  layouts  for  a  demon¬ 
stration  according  to  the  number  of  host  machines  being  usecL^ 

The  DOSE  application  is  composed  of  four  components:  Parser  Manager,  Track  Report  Man¬ 
ager,  Graphics  Map  Client,  and  Database  Monitor  Client.  The  scenario  used  to  test  and  demon¬ 
strate  the  DOSE  application  is  an  outer  air-battle  scenario  generated  at  NO  SC. -The  grffnaHr>  fn»  ic 
sent  to  a  Network  Interface  Unit  (NIU)  client  that  packages  the  raw  Navy  Tactical  Data  System 
(NTDS)  data  read  in  from  the  Data  Terminal  Set  (DTS)  into  blocks.  This,  in  turn,  sends  LINK  11,  a 
high-speed,  high-frequency  or  ultrahigh-frequency  data  transmission  net  that  connects  ships  and  air¬ 
craft  equipped  with  the  NTDS,  to  the  Parser  Manager.  The  primary  function  of  the  Parser  Manager  is 
to  convert  these  Link  1 1  binary  messages  into  ASCII  text.  Due  to  the  sensitive  nature  of  the  Link  1 1 
data  formats,  there  exists  a  classified  and  an  unclassified  version  of  the  Parser  Manager.  In  the  un¬ 
classified  version,  the  operation  of  parsing  blocks  of  binary  data  is  unimplemented.  Instead,  previously 
parsed  track  information  is  stored  in  a  file  to  be  read  by  the  Parser  Manager.  The  track  information 
is  passed  to  a  Track  Report  Manager  for  storage  in  its  object  database.  Cronus  object  database  is  not 
a  relational  database  system  such  as  Informix  or  Oracle.  Cronus  database  is  a  stable  storage  used  by 
an  object  manager  (Track  Report  Manager)  to  maintain  the  instance  variables  (member  of  the  com¬ 
mon  characteristics  for  a  set  of  objects),  replication  information,  and  access  control  lists  that  make  up 
the  objects  that  the  manager  manages.  Existing  multiple  copies  of  the  Track  Report  Manager  may  be 
concurrently  running  with  replicated  data  objects.  For  each  new  track  information  received,  a  new 
object  is  created  by  the  Track  Report  Manager.  For  track  updates,  the  Track  Report  Manager 
searches  through  its  object  database  using  the  vack  number  as  the  key  and  overwrites  the  appropriate 
object  content  with  the  new  information.  The  track  information  can  then  be  displayed  by  the  Graphics 
Map  Client  using  an  unclassified  NTDS  symbology.  The  Track  Report  Manager  also  services  the  Data¬ 
base  Monitor  Client  that  monitors  the  number  of  objects  in  each  of  the  Track  Report  Managers’  repli¬ 
cated  object  databases.  The  Database  Monitor  Client  also  ir^uk. (broadcasts)  Cronus'  RunUp- 
date Daemon  that  updates  the  replicated  objects  (for  consister  t  <  >  ,n  the  object  database  of  all  the 
Track  Report  Managers. 


There  are  two  companion  documents  to  this  User’s  Manual.  The  Distributed  Operating  System 
Experiment  1988  Source  Code  (Kwong,  1989)  provides  an  overview  of  the  DOSE  application  and  the 
unclassified  source  code  to  the  application.  The  Distributed  Operating  System  Experiment  (DOSE) 
Application  Installation  Manual  (Gadbois,  1990)  describes  the  procedures  for  installing  the  DOSE  ap¬ 
plication. 

This  document  assumes  the  user  is  familiar  with  the  Cronus  computing  environment  and  the 
UNIX  environment. 
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2.0  DOSE  COMPONENTS 


2.1  PARSER  MANAGER 

The  Parser  Manager  was  designed  and  developed  under  UNIX  using  transmission  control  proto- 
cols/interprocess  communication  (TCP/IP)  and  then  redesigned  to  be  a  Cronus  manager.  To  increase 
survivability,  portability,  and  availability,  the  Parser  Manager  was  written  with  the  capability  to  run  on 
UNIX  and  VMS  machines.  The  Parser  Manager  is  currently  running  on  Sun  Workstations  (UNIX) 
and  Micro  VAX  II  (VMS)  in  the  NOSC  testbed. 

The  Parser  Manager  services  an  NIU  client  that  sends  the  Parser  manager  raw  Link  11  data.  The 
primary  function  of  the  Parser  Manager  is  to  convert  these  Link  11  binary  messages  into  ASCII  text. 
The  ASCII  text  is  sent  to  the  Track  Report  Manager  for  storage.  The  subset  of  Link  1 1  messages 
handled  are  equivalent  to  the  subset  handled  by  the  Dots  4.0  Link  11  decoder  implemented  on  a 
HP9020  and  prototyped  on  the  USS  Carl  Vincent.  The  messages  that  the  Parser  Manager  does  not 
handle  are  ignored.  Erroneous  data  messages  are  also  ignored.  These  binary  messages  contain  unclas¬ 
sified  information  about  tracks  such  as  latitude,  longitude,  type,  and  category.  Even  though  the  Parser 
Manager  is  a  Cronus  manager,  it  does  not  save  or  store  track  information. 

Due  to  the  sensitive  nature  of  the  Link  1 1  data  formats,  an  unclassified  version  of  the  Parser 
Manager  was  created  for  public  distribution.  The  parsing  operation  of  the  binary  data  is  unimple¬ 
mented.  In  its  place  is  an  operation  that  reads  previously  parsed  unclassified  track  information  (ASCII 
characters)  stored  in  a  file.  The  Parser  Manager  then  passes  the  track  information  to  the  Track 
Report  Manager  for  storage. 

The  Parser  Manager  performs  the  following  eight  operations: 

Setdlro  Due  to  the  nature  of  the  Link  1 1  data,  the  user  must  set  the  Data  Link  Reference  Point 
(DLRP)  prior  to  sending  data  to  the  Parser  Manager.  The  DLRP  is  set  by  invoking  this  operation  via 
the  Cronus  support  and  debug  tool,  tropic.  The  parameters  to  the  operation  are  the  latitude  and  lon¬ 
gitude  (in  minutes)  of  the  new  DLRP.  The  Setdlrp  operation  is  unimplemented  in  the  unclassified  ver¬ 
sion  of  the  Parser  Manager. 

Getdlrp  The  latitude  and  longitude  information  (in  minutes)  of  the  DLRP  can  be  obtained  by  invok¬ 
ing  this  operation  via  tropic.  The  Getdlrp  operation  is  unimplemented  in  the  unclassified  version  of 
the  Parser  Manager. 

SetDisplavTextFlag  One  of  the  means  to  debug  the  Parser  Manager  and  check  for  correctness  of  the 
parsing  algorithm  is  to  textually  display  the  parsed  track  information  on  the  terminal.  This  capability 
can  be  controlled  by  the  user  by  invoking  the  SetDisplayTextFlag  operation  via  tropic  and  setting  the 
flag  to  either  on  or  off.  The  flag  is  set  to  off  by  default. 

SetSendtrmFlay  The  Parser  Manager  passes  the  parsed  track  information  to  the  Track  Report  Man¬ 
ager  for  storage.  The  Track  Report  Manager  does  not  have  to  be  running  for  debugging  and  testing 
purposes  of  the  Parser  Manager.  However,  if  the  Track  Report  Manager  is  not  running,  the  Parser 
Manager  will  attempt  to  invoke  it,  resulting  in  repeated  timeouts  and  causing  a  lock-up.  To  remedy 
this  situation,  the  SetSendtrmFlag  operation  allows  the  user  to  set  the  flag  to  off,  which  signals  the 
Parser  Manager  not  to  send  track  information  to  the  Track  Report  Manager.  The  operation  is  invoked 
via  tropic  and  the  flag  is  set  to  on  by  default. 

SetGraphicsFlaf  A  Cronus  manager  is  usually  a  hidden  service.  For  demonstration  purposes,  the  Par¬ 
ser  Manager  has  a  graphics  capability  that  displays  monitoring  information  about  its  status  and  the 
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data  flowing  through  it  (figure  1).  The  SetGraphicsFlag  operation  allows  the  user  to  activate  the  Parser 
Manager’s  graphics  by  setting  the  flag  to  on  via  tropic.  The  flag  is  set  to  off  by  default. 


NTDS  SHIP 


PROCESS  INFORMATION 


12 


TRACK  INFORMATION 


FRIENDLY 

HOSTILE 


I  1  -  UNKNOWN 


Figure  1.  Parser  Manager  graphical  display. 


SetDemoFlag  The  Parser  Manager  processes  many  messages  at  a  time  and  immediately  passes  the 
information  to  the  Track  Report  Manager.  Besides  serving  the  Parser  Manager,  the  Track  Report 
Manager  also  services  the  Graphics  Map  Client  and  the  Database  Monitor  Client.  In  addition,  the 
Track  Report  Manager  manages  replicated  data  objects  when  multiple  copies  of  the  manager  are 
running.  The  Track  Report  Manager  also  provides  graphics  display  capability  during  the  demonstra¬ 
tion.  Thus,  the  many  demands  made  on  the  Track  Report  Manager  will  slow  down  its  processing, 
which  will  result  in  a  backlog  in  attempting  to  handle  the  information  being  sent  by  the  Parser 
Manager.  To  avoid  timeout  errors  and  overloading  the  Track  Report  Manager,  the  Parser  Manager 
will  calculate  and  set  a  timeout  variable  based  on  a  prediction  of  the  time  the  Track  Report  Manager 
will  take  to  process  each  track  information.  Thus,  the  Parser  Manager  will  sleep  according  to  the 
timeout  variable  between  invocations  on  the  Track  Report  Manager.  The  timeout  variable  defaults  to 
30  seconds.  This  capability  is  activated  by  setting  the  flag  on  to  the  SetDemoFlag  operation  via  tropic. 
The  flag  is  set  to  off  by  default. 
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ParseBlock  An  NIU  client  running  on  an  access  machine,  which  is  an  interface  from  a  Link  1 1  data 
terminal  set  to  the  Cronus  environment,  invokes  the  ParseBlock  operation  sending  raw  Link  1 1  data 
to  the  Parser  Manager.  The  operation  parses  the  block  of  Link  1 1  data  contained  in  the  array  of 
Link  11  messages  and  sends  the  parsed  ASCII  data  to  the  Track  Report  Manager.  The  parsed  data 
are  sent  in  blocks  to  the  Track  Report  Manager  to  reduce  the  number  of  invocations.  The  ParseBlock 
operation  is  unimplemented  in  the  unclassified  version  of  the  Parser  Manager. 

ReadTrack  Due  to  the  sensitivity  of  the  Link  11  data  formats,  the  ParseBlock  operation  is  replaced 
by  the  ReadTrack  operation  in  the  unclassified  version  of  the  Parser  Manager.  The  ReadTrack  opera¬ 
tion  reads  already  parsed  track  information  from  an  ASCII  file  called  trackfile.  The  hie  groups  the 
track  information  into  blocks.  Each  block  contains  a  varied  number  of  track  information  (figure  2). 
The  beginning  of  each  block  is  a  number  that  indicates  the  number  of  tracks  in  that  block.  Each  line 
in  the  file  represents  the  data  that  defines  the  track:  track  number,  latitude  of  the  track,  longitude  of 
the  track,  bearing  from  the  DLRP,  depth  or  height  of  the  track,  latitude  of  DLRP,  longitude  of 
DLRP,  type  of  platform,  idendty  or  category  of  the  track,  greenwich  mean  time,  track  quality,  latitude 
direction  (north  or  south),  longitude  direction  (east  or  west),  course,  speed,  range  from  DLRP,  and 
nuclear  status.  The  Parser  Manager  reads  in  the  block  of  track  information  and  partitions  the  block 
into  an  array  with  a  maximum  of  eight  tracks.  These  eight  tracks  are  sent  to  the  Track  Report  Man¬ 
ager  via  invoking  the  operation,  TrackUpdate.  After  the  Parser  Manager  finishes  sending  all  the  tracks 
in  the  block  to  the  Track  Report  Manager,  the  Parser  Manager  reads  in  the  next  block  of  track  infor¬ 
mation.  This  operation,  which  does  not  perform  any  parsing  action,  is  invoked  via  tropic. 

2.2  TRACK  REPORT  MANAGER 

Designed  specifically  for  the  DOSE  application,  the  Track  Report  Manager  is  an  object  database 
manager  that  manages  Navy  track  objects.  The  Track  Report  Manager,  which  runs  only  on  UNIX 
machines,  is  a  fully  replicated  Cronus  manager  that  services  the  Parser  Manager,  Graphics  Display 
Client,  and  Database  Monitor  Client.  The  Track  Report  Manager  can  be  ported  to  run  on  VMS 
machines  like  the  Parser  Manager.  However,  the  porting  has  not  been  done  because  of  the  desire  for 
Track  Report  Manager’s  graphics  capability. 

The  Track  Report  Manager  manages  a  database  of  data  objects  that  are  replicated  with  each  copy 
of  the  Track  Report  Manager.  The  replication  mechanism  is  provided  by  Cronus,  which  is  responsible 
for  maintaining  consistency  and  resolving  conflicts  between  replicated  object  databases.  Each  Track 
Report  Manager  data  object  is  a  record  of  track  information  (track  number,  latitude,  longitude,  etc.) 
sent  by  the  Parser  Manager.  The  track  information  received  by  the  Track  Report  Manager  is  either 
new  or  an  update  to  an  existing  track  object.  For  each  new  track,  a  new  object  is  created  and  added 
to  the  database.  For  each  track  update,  the  Track  Report  Manager  searches  through  its  object  data¬ 
base  using  the  track  number  as  the  key  and  overwrites  the  already  existing  information  stored  in  the 
track  object. 
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1  2680.00  9249.00 
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3  2700.25  9270.50 

4  2708.26  9241.00 
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24 

1  2680.00  9249.00 

2  2692.26  9221.76 

3  2700.26  9270.60 

4  2708.26  9241.76 
6  2678.26  9269.00 

6  2699.26  9253.25 

7  2681.00  9229.26 

10  2666.00  9243.50 

11  2728.60  9262.26 

12  2716.60  9213.60 
16  2667.00  9268.26 
14  2666.00  9263.26 

4232  2776.26  9194.00 

4233  2679.26  9068.60 

4234  2768.00  9095.76 
4236  2823.76  9166.26 

4236  2842.00  9249.76 

4237  2813.75  9326.25 

4240  2786.26  9142.00 

4241  2810.76  9173.60 

4242  2826.76  9210.76 

4243  2778.26  9193.26 

4244  2802.60  9244.26 
4246  2676.26  9122.60 
34 

1  2680.00  9260.00 

2  2692.26  9222.76 

3  2701.26  9270.76 

4  2708.26  9242.00 
6  2679.26  9260.00 

6  2699.26  9263.26 

7  2681.00  9229.60 

10  2666.00  9243.60 

11  2728.60  9262.60 

12  2716.60  9213.75 
16  2667.00  9268.26 
14  2866.00  9263.26 

4232  2779.26  9192.60 


241.36  -99999.00  2700.00 
261.49  -99999.00  2700.00 

270.86  -99999.00  2700.00 

281.66  -99999.00  2700.00 
233.46  -99999.00  2700.00 

267.31  -99999.00  2700.00 
248.68  -99999.00  2700.00 

229.76  -99999.00  2700.00 

318.19  -99999.00  2700.00 

283.87  -99999.00  2700.00 
222.03  -99999.00  2700.00 

222.98  -99999.00  2700.00 

314.20  0.00  2700.00 

263.86  0.00  2700.00 

296.44  0.00  2700.00 

322.38  0.00  2700.00 

344.94  0.00  2700.00 

7.60  0.00  2700.00 

308.39  0.00  2700.00 

320.79  0.00  2700.00 

332.67  0.00  2700.00 

313.39  0.00  2700.00 

336.79  0.00  2700.00 

268.70  0.00  2700.00 

241.36  -99999.00  2700.00 

262.60  -99999.00  2700.00 

270.86  -99999.00  2700.00 

281.68  -99999.00  2700.00 
233.46  -99999.00  2700.00 

268.98  -99999.00  2700.00 
249.07  -99999.00  2700.00 
230.07  -99999.00  2700.00 
317.22  -99999.00  2700.00 

284.76  -99999.00  2700.00 

222.20  -99999.00  2700.00 
223.78  -99999.00  2700.00 

316.44  0.00  2700.00 

264.16  0.00  2700.00 

296.64  0.00  2700.00 

323.91  0.00  2700.00 

348.63  0.00  2700.00 

8.96  0.00  2700.00 

308.96  0.00  2700.00 

322.28  0.00  2700.00 

334.31  0.00  2700.00 

316.99  0.00  2700.00 

339.58  0.00  2700.00 

269.93  0.00  2700.00 

240.87  -99999.00  2700.00 

262.39  -99999.00  2700.00 

273.63  -99999.00  2700.00 
281.73  -99999.00  2700.00 
234.06  -99999.00  2700.00 
268.98  -99999.00  2700.00 

249.60  -99999.00  2700.00 
230.07  -99999.00  2700.00 
317.41  -99999.00  2700.00 

284.80  -99999.00  2700.00 

222.20  -99999.00  2700.00 
223.78  -99999.00  2700.00 

317.17  0.00  2700.00 


9300.00  S  F  0  0  N  E 
9300.00  S  F  0  6  N  E 
9300.00  S  F  0  8  N  E 
9300.00  S  F  0  6  N  E 
9300.00  SF  0  6  N  E 
9300.00  S  F  0  8  N  E 
9300.00  S  F  0  6  N  E 
9300.00  SF  0  8  N  E 
9300.00  S  F  0  8  N  E 
9300.00  S  F  06NE 
9300.00  SF  0  6  N  E 
9300.00  SF  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  6  N  E 
9300.00  AF  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  5  N  E 

9300.00  S  F  0  0  N  E 
9300.00  S  F  0  6  N  E 
9300.00  SF  0  8  N  E 
9300.00  S  F  0  9  N  E 
9300.00  SF  0  6  N  E 
9300.00  SF  0  6  N  E 
9300.00  S  F  0  8  N  E 
9300.00  S  F  0  6  N  E 
9300.00  S  F  0  8  N  E 
9300.00  SF  0  6  N  E 
9300.00  SF  0  6  N  E 
9300.00  S  F  0  6  N  E 
9300.00  AF  0  6  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  5  N  E 
9300.00  A  F  0  6  N  E 
9300.00  AF  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  A  F  0  6  N  E 
9300.00  AF  0  6  N  E 
9300.00  AF  0  5  N  E 
9300.00  AF  0  5  N  E 

9300.00  S  F  0  0  N  E 
9300.00  S  F  0  6  N  E 
9300.00  S  F  0  6  N  E 
9300.00  S  F  0  6  N  E 
9300.00  S  F  0  6  N  E 
9300.00  SF  0  6  N  E 
9300.00  S  F  0  6  N  E 
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9300.00  S  F  0  8  N  E 
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Figure  2.  Sample  scenario  file. 

The  Track  Report  Manager  performs  the  seven  operations  that  are  described  below: 

InitialiieDB  The  Track  Report  Manager  manages  two  object  types,  TrackReportData  and  Track- 
Table Index.  TrackReportData  is  the  type  definition  for  the  track  objects  that  the  Track  Report  Man¬ 
ager  manages.  TrackTablelndex  is  the  type  definition  for  the  TrackTable,  which  is  a  list  of  track 
entries.  Each  track  entry  consists  of  a  unique  track  number,  an  object  UID  that  identifies  the  track 
object  associated  with  the  track  number,  and  a  version  number  that  records  the  last  time  the  track 
object  was  updated.  The  TrackTable  is  used  as  a  reference  to  the  track  objects  maintained  by  the 
Track  Report  Manager’s  object  database.  The  InitializeDB  operation  removes  the  data  in  the  object 
database  of  type  TrackReportData  to  ensure  a  clean  database  when  first  running  the  Track  Report 
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Manager.  This  operation  also  creates  a  new  object  for  the  type  TrackTablelndex  that  stores  the 
TrackTable.  The  UID  of  the  TrackTable  object  is  stored  in  Track  Report  Manager's  generic  as  a  ref¬ 
erence  to  identify  which  object  maintains  the  TrackTable.  The  InitializeDB  operation  must  be  in¬ 
voked,  via  tropic,  before  any  other  operadons  are  invoked  on  the  Track  Report  Manager. 

SetMonitorFlag  For  demonstration  purposes,  the  Track  Report  Manager  has  a  graphics  capability 
that  displays  the  flow  of  operadon  invocadon  from  the  Parser  Manager  and  Graphics  Map  Client 
(figure  3).  The  SetMonitorFlag  operadon  allows  the  user  to  activate  the  Track  Report  Manager's 
graphics  by  setting  the  flag  to  on  via  tropic.  The  flag  is  set  to  off  by  default. 

DOSE  1988 


MICKEY 


SNOOPY 


PEPI 


Figure  3.  Track  Report  Manager  graphical  display. 

Trackllpdate  The  Parser  Manager  passes  an  array  of  track  information  to  the  Track  Report  Manager 
by  invoking  the  TrackUpdate  operation.  Each  track  is  searched  in  the  TrackTable  (created  by  the 
InitializeDB  operation)  using  the  track  number  as  the  search  key.  If  the  track  number  is  not  found  in 
the  TrackTable,  this  operation  will  create  a  new  object  to  store  the  new  track  information.  The  track 
number  and  the  UID  of  the  newly  created  object  are  entered  in  the  TrackTable  for  future  reference. 
If  the  track  number  is  found  in  the  TrackTable,  the  object  UID  associated  with  the  track  number  is 
used  to  locate  the  track  object  in  the  Track  Report  Manager’s  database  in  which  the  new  track  infor¬ 
mation  overwrites  the  old  information.  The  version  number  in  the  TrackTable  associated  with  this 
track  number  is  incremented  to  reflect  the  update  of  the  track  object. 

GetCurrentTracks  The  Graphics  Map  Client  provides  a  graphics  view  of  the  track  objects  managed 
by  the  Track  Report  Manager.  Track  information  is  obtained  by  invoking  the  GetCurrentTracks 
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operation.  The  client  maintains  an  epoch  number  that  records  the  latest  version  of  track,  information 
that  the  client  has  received.  This  epoch  number  is  the  parameter  to  the  GetCurrentTracks  operation 
that  is  used  for  comparison  with  the  specific  version  number  of  each  track  entry  in  the  TrackTable. 
An  array  of  track  information  with  version  numbers  greater  than  the  epoch  parameter  is  returned  to 
the  client.  The  client  updates  the  epoch  number  for  the  next  invocation.  If  the  parameter  to  the  op¬ 
eration  is  zero,  all  the  track  information  in  the  Track  Report  Manager’s  database  is  returned.  For  de¬ 
bugging  purposes,  the  operation  can  be  invoked  via  tropic,  which  will  textually  display  the  contents  of 
each  track  object.  The  information  returned  by  the  GetCurrentTracks  operation  consists  of  a  track 
number,  latitude  and  longitude  of  the  track,  bearing,  latitude  and  longitude  of  the  DLRP,  altitude/ 
depth,  platform_type  (e.g.,  aircraft,  surface  ship,  subsurface  ship),  and  category  (friendly,  hostile, 
unknown) . 

GetTrack  The  Graphics  Map  Client  requires  only  the  track  number,  latitude  and  longitude  position  of 
the  track,  altitude/depth,  platform_type,  and  category  information  of  each  track  to  draw  the  proper 
icon  on  the  map.  For  full  information  about  a  specific  track,  the  GetTrack  operation  returns  the 
information  provided  by  the  GetCurrentTracks  operation,  as  well  as  additional  information  on  track 
time,  track  quality,  latitude  and  longitude  direction,  course,  speed,  range  from  DLRP,  and  nuclear 
identification.  The  Graphics  Map  Client  invokes  the  GetTrack  operation  with  the  object  UID  of  the 
track  requested.  The  object  UID  is  used  to  search  the  Track  Report  Manager’s  database  for  the  infor¬ 
mation  of  the  requested  track.  Similar  to  the  GetCurrentTracks  operation,  this  operation  can  be 
invoked  via  tropic  for  debugging  purpose. 

GetObiectDBStatus  To  monitor  the  status  of  replicated  Track  Report  Managers,  the  Database  Moni¬ 
tor  Client  invokes  the  GetObjectDBStatus  operation,  which  returns  the  number  of  objects  managed  by 
each  Track  Report  Manager  and  the  epoch  number  of  the  last  update  of  the  objects  in  the  database. 
The  operation  can  also  be  invoked  via  tropic  for  debugging  purpose. 

GetTInfo  For  debugging  purpose,  the  GetTInfo  operation  returns  the  information  about  the  tasks  cur¬ 
rently  running.  The  operation  is  invoked  via  tropic. 

2.3  GRAPHICS  MAP  CLIENT 

The  Graphics  Map  Client  is  a  worldwide  dynamically  scaled  map  package  with  the  ability  to  dis¬ 
play  navy  track  symbols  and  other  information.  The  map  software  is  a  modification  of  a  map  genera¬ 
tor  designed  at  the  Information  Sciences  Institute,  University  of  Southern  California,  that  uses  the 
Graphics  Language  device  independent  graphics  package.  This  software  was  modified  to  use  SurtCore, 
a  graphics  package  for  Sun  workstations,  to  construct  the  map  from  a  digital  map  database.  The  soft¬ 
ware  was  originally  designed  as  a  situation  assessment  display  for  the  Combat  System  Experiments 
project  at  NOSC.  The  model  of  the  display  was  modified  to  run  as  a  Cronus  client  with  the  capability 
to  interface  with  a  Cronus  manager  instead  of  interfacing  with  a  centralized  database. 

The  Graphics  Map  Client  provides  a  graphical  view  of  the  object  database  maintained  by  the 
Track  Report  Manager  (figure  4).  Navy  tracks  stored  in  the  object  database  are  displayed  in  unclassi¬ 
fied  NTDS-Iike  symbology.  The  scenario  used  to  test  and  demonstrate  the  DOSE  application  is  an 
outer  air-battle  scenario  generated  by  the  Interim  Battle  Group  Tactical  Trainer  (IBGTT),  which  was 
recently  renamed  Research,  Evaluation,  and  Systems  Analysis  (RESA).  This  scenario  takes  place  in 
the  Pacific  Ocean  with  the  DLRP  at  approximately  40  degrees  latitude  and  180  degrees  longitude.  The 
74  tracks  are  a  mixture  of  friendly,  hostile,  and  unknown  ships  and  aircrafts.  Movement  and  modifi¬ 
cations  of  the  tracks  in  the  Track  Report  Manager  object  database  are  reflected  on  the  map.  For 
example,  if  an  unknown  ship  is  later  identified  as  a  hostile  ship,  the  icon  will  change  to  reflect  the 
new  identity. 
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Figure  4.  Graphics  Map  Client  display. 
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The  user  can  interactively  manipulate  the  display  via  menus  that  are  controlled  by  the  mouse 
device.  The  following  ten  selections  are  available  on  the  top-level  menu: 

1.  Symbol  legend  -  displays  a  symbol  legend. 

2.  Track  -  allows  the  user  to  pick  a  track  on  the  map  (using  the  mouse)  to  display  detailed 
information  about  the  particular  track.  This  selection  invokes  the  GetTrack  operation. 

3.  Radius  -  allows  the  user  to  change  the  radius  of  the  map  (in  miles).  This  provides  zoom¬ 
ing  and  panning  effects. 

4.  Center  -  allows  the  user  to  change  the  center  (latitude,  longitude)  of  the  map  (in  de¬ 
grees). 

5.  Color  -  allows  the  user  to  change  the  color  (for  color  monitors)  or  pattern  (for  mono¬ 
chrome  monitors)  of  the  land  on  the  map. 

6.  Fill  -  allows  the  user  to  select  filled  or  outlined  land  forms  on  the  map. 

7.  3-D  -  allows  the  user  to  select  the  level  of  tilting  of  the  map  to  provide  a  3-dimensional 
projection. 

8.  Restrict  -  brings  up  a  submenu  for  the  user  to  select  the  type  of  tracks  to  display  (for 
example,  select  only  air  friend  tracks  to  be  displayed  on  the  map). 
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9.  Refresh  -  redraws  the  screen  display. 

10.  Exit  -  exits  from  the  menu. 

The  Graphics  Map  Client  automatically  invokes  the  GetCurrentTracks  operation  every  three  seconds 
for  the  most  recent  track  information. 

2.4  DATABASE  MONITOR  CLIENT 

The  Database  Monitor  Client  is  an  aid  to  Cronus’  replication  capability  of  the  Track  Report  Man¬ 
ager.  The  client  invokes  Cronus’  UpdateDaemon,  which  updates  the  replicated  objects  in  the  object 
database  of  all  the  Track  Report  Managers.  This  invocation  is  performed  every  15  seconds  by  default, 
that  is,  the  client  sleeps  for  15  seconds  after  each  invocation.  The  user  has  the  option  to  set  the  sleep 
period  when  the  Database  Monitor  Client  is  activated.  If  the  sleep  period  is  set  to  a  very  low  value 
(e.g.,  less  than  a  second),  the  continuing  invocation  of  the  UpdateDaemon  will  take  away  processing 
time  from  other  processes.  If  the  sleep  period  is  set  to  a  large  value  (e.g.,  more  than  10  minutes),  it 
defeats  the  purpose  of  using  the  UpdateDaemon  to  ensure  consistency  of  the  object  databases  espe¬ 
cially  since  the  DOSE  demonstration  is  only  20  minutes  long.  The  invocation  to  the  UpdateDaemon  is 
necessary  because  the  replicated  Track  Report  Managers  were  not  able  to  keep  in  sync  with  each 
other.  This  is  due  to  the  massive  number  of  track  updates  the  Parser  Manager  sends  to  the  Track 
Report  Manager.  The  Parser  Manager  sends  an  array  of  eight  tracks  to  the  Track  Report  Manager  per 
invocation  ( TrackUpdate ).  After  the  Track  Report  Manager  completes  the  operation,  it  propagates  the 
eight  changes  to  the  other  replicated  Track  Report  Managers.  This  propagation  may  not  complete 
because  the  Parser  Manager  will  again  invoke  the  Track  Report  Manager  with  new  track  updates. 

The  Database  Monitor  Client  also  acts  as  a  debug  aid.  It  broadcasts  to  all  thf»  replicated  Track 
Report  Managers  and  invokes  the  operation  GetObjectDBStatus  for  the  number  of  objects  being  man¬ 
aged  by  each  manager.  If  the  Track  Report  Manager  graphics  display  is  on,  the  number  of  objects  will 
be  displayed.  Also  displayed  will  be  the  updated  version  number  that  represents  the  number  of 
updates  performed  by  the  Track  Report  Manager.  These  numbers  provide  a  quick  visual  aid  to  show 
that  the  Track  Report  Managers  are  in  sync  with  each  other. 
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3.0  DOSE  DEMONSTRATION 


3.1  HARDWARE  AND  SOFTWARE  CONFIGURATION 

In  order  to  demonstrate  the  DOSE  application  efficiently,  the  following  display  equipment  and 
software  are  needed: 

1.  A  minimum  of  two  Sun  2  or  Sun  3  workstations  with  a  monitor  (color  or  monochrome), 
that  will  be  used  for  various  graphics  displays.  Sun  386i  workstations  can  be  used  to  run 
the  DOSE  application  without  graphics  displays.  (The  SunCore  graphics  package  is  not 
supported  on  the  Sun  386i  workstations.) 

2.  A  microterminal  (or  equivalent)  connected  to  each  Sun  workstation  that  will  be  used  to 
activate  graphics  displays  on  the  Sun  monitor. 

3.  The  suntools  software  package  that  will  be  used  to  provide  multiple  windows  if  hardware 
(Sun  workstation  and  microterminal)  availability  is  limited. 

4.  The  SunCore  graphics  package  that  will  be  used  by  the  DOSE  managers  and  clients  to 
provide  graphics  displays. 

3.2  DEMONSTRATION  STARTUP 

The  configuration  layout  of  the  DOSE  application  consists  of  four  directories: 

DBclient  graphics  parser  trackrpt 

The  DBclient  directory  contains  the  Database  Monitor  Client.  The  graphics  directory  contains 
the  Graphics  Map  Client.  The  parser  directory  contains  the  Parser  Manager  and  the  trackrpt  direc¬ 
tory  contains  the  Track  Report  Manager. 

The  Parser  Manager,  Graphics  Map  Client,  and  Database  Monitor  Client  all  invoke  the  Track 
Report  Manager.  Thus,  the  Track  Report  Manager  must  be  started  first.  The  following  describes  how 
to  start  each  manager  and  client  to  demonstrate  the  DOSE  application. 

3.3  TRACK  REPORT  MANAGER  STARTUP 

The  Track  Report  Manager  manages  replicated  data  objects  in  its  database.  To  demonstrate  this 
feature,  multiple  copies  of  the  Track  Report  Manager  should  be  running  on  multiple  host  machines. 

To  bring  up  the  first  Track  Report  Manager,  login  as  a  Cronus  user  and  go  to  the  directory  that 
contains  the  executable  trm  ( trackrpt  directory). 

%  cronus  login  cronus_user 
%  cd  trackrpt 

The  Track  Report  Manager  is  a  Cronus  manager.  Thus,  the  object  database  for  its  object  type 
needs  to  be  created.  The  syntax  is  ldbcreate=num  where  num  is  the  type  number  of  the  manager. 

The  Track  Report  Manager  manages  two  databases  (types  321  and  322).  By  specifying  num  as  0,  all 
appropriate  databases  are  created  for  the  manager. 

%  trm  /dbcreate=0 
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This  execution  creates  two  files  in  the  current  directory:  objectdb.321  and  objectdb.322. 

To  activate  the  manager,  type  the  following  command: 

%  trm  / interactive 

This  executes  the  Track  Report  Manager  in  the  foreground.  Any  messages  from  the  manager  will 
be  printed  onto  the  screen.  The  manager  can  also  be  activated  in  the  background  by  replacing  / inter¬ 
active  with  &  to  the  above  command  line.  Messages  from  the  manager  will  be  stored  in  the  log.txt 
file. 


The  procedure  for  activating  other  Track  Report  Managers  on  other  host  machines  (Cronus  will 
not  allow  multiple  copies  of  a  Cronus  manager  to  run  on  the  same  host  machine),  is  similar  to  activat¬ 
ing  the  first  Track  Report  Manager,  except,  that  Idbreplicale  is  used  instead  of  Idbcreate. 

%  cronus  login  cronus_user 
%  cd  trackrpt 
%  trm  ldbreplicate-0 
%  trm  / interactive 

After  the  Track  Report  Manager(s)  are  up  and  running,  use  tropic  to  initialize  one  of  the  Track 
Report  Manager’s  object  database: 

%  cronus  tropic 

command:  on  {321}@host  InitializeDB 

@host  is  the  hostname  of  the  machine  on  which  the  Track  Report  Manager  was  first  activated. 

The  Track  Report  Manager  has  graphics  capability.  To  activate  the  graphics  display,  invoke  the 
operation  SetMonitorFlag  and  set  the  flag  option  through  tropic: 

%  cronus  tropic 

command:  on  (321}@host  SetMonitorFlag  /flag 

@host  is  the  hostname  of  the  machine  on  which  the  Track  Report  Manager  is  running.  If  there  are 
multiple  Track  Report  Managers  running  and  the  user  wishes  to  activate  graphics  for  all  copies, 
broadcast  can  be  used  as  the  hostname. 

To  deactivate  the  graphics  display,  use  the  Inoflag  option.  By  default,  the  option  is  set  to  /noflag. 

There  are  debug  statements  in  the  Track  Report  Manager  that  will  output  to  the  screen  (where 
the  manager  was  activated)  when  the  manager  is  running.  If  the  Sun  Monitor  is  being  used  for  the 
graphics  display  of  the  manager,  it  is  best  to  activate  the  manager  on  a  microterminal  (or  equivalent) 
connected  to  the  Sun  so  that  the  debug  statements  will  be  printed  on  the  microterminal.  Otherwise, 
the  debug  statements  will  write  on  top  of  the  graphics  display. 

3.4  PARSER  MANAGER  STARTUP 

The  Parser  Manager  manages  one  type  of  object.  Unlike  the  Track  Report  Manager,  it  does  not 
store  information  in  its  object  database.  The  Parser  Manager  is  a  Cronus  manager  that  functions  as  a 
client  to  the  Track  Report  Manager.  Duplicate  copies  of  the  Parser  Manager  (the  Parser  Manager  is 
not  a  replicated  manager  like  the  Track  Report  Manager)  can  be  running  on  multiple  host  machines. 
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However,  for  a  demonstration  purpose,  usually  only  one  Parser  Manager  is  actively  running  and  sup¬ 
plying  track  information  to  the  Track  Report  Manager  (s). 

To  activate  the  Parser  Manager,  login  as  a  Cronus  user  and  go  to  the  directory  that  contains  the 
executable  parser  (parser  directory): 

%  cronus  login  cronus_user 

%  cd  parser 

The  Parser  Manager  is  a  Cronus  manager,  thus,  the  object  database  for  its  type  (this  manager 
manages  only  one  type,  320)  needs  to  be  created. 

%  parser  /dbcreate=320 

This  execution  creates  1  file  in  the  current  directory:  objectdb.320. 

To  activate  the  manager,  type  the  following  command: 

parser  /interactive 

The  Parser  Manager  also  has  graphics  capability.  To  activate  the  graphics  display,  invoke  the 
operation  SetGraphicsFlag  and  set  the  option  flag  through  tropic: 

%  cronus  tropic 

command:  on  {320}@host  SetGraphicsFlag  /flag 

To  deactivate  the  graphics  display,  use  the  /noflag  option.  By  default,  the  option  is  set  to  / noflag . 

The  unclassified  version  of  the  Parser  Manager  reads  already  parsed  data  stored  in  trackfile,  an 
ASCII  file.  The  operation  ReadTracks  was  created  for  this  purpose: 

%  cronus  tropic 

command:  on  {320}@host  ReadTracks  trackfile 

3.5  GRAPHICS  MAP  CLIENT  STARTUP 

The  Graphics  Map  Client  is  a  Cronus  client  that  invokes  the  Track  Report  Manager  for  track 
information.  Unlike  the  Track  Report  Manager  and  the  Parser  Manager,  the  Graphics  Map  Client 
does  not  have  the  option  of  turning  on  or  off  its  graphics  display  since  its  purpose  is  to  graphically 
display  the  track  information.  Thus,  the  microterminal  must  be  connected  to  the  Sun  workstation  to 
activate  the  graphics  display  on  the  Sun  Monitor  (to  take  advantage  of  full  screen  display).  If  a 
microterminal  is  not  available,  the  Graphics  Map  Client  can  be  run  in  GraphicsTool  of  suntool  win¬ 
dow. 

To  activate  the  Graphics  Map  Client,  go  to  the  directory  that  contains  the  executable  graphics 
( graphics  directory)  and  startup  the  executable. 

%  cd  graphics 

%  graphics 

Successful  activation  of  the  Graphics  Map  Client  will  display  a  map  on  the  monitor.  A  request  to 
push  the  right  button  on  the  mouse  flashes  on  the  right-hand  side  of  the  screen.  This  action  brings  up 
a  menu  that  allows  the  user  to  manipulate  the  map  and  view  the  tracks  in  different  perspectives  as 
described  in  section  2.3. 
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3.6  DATABASE  MONITOR  CLIENT  STARTUP 


The  Database  Monitor  Client  is  a  Cronus  client  that  invokes  the  Track  Report  Manager  for  the 
number  of  objects  in  its  object  database.  This  client  has  no  graphics  display  capability.  However,  the 
information  the  Database  Monitor  Client  receives  is  displayed  on  the  Track  Report  Manager  graphics 
display. 

To  activate  the  Database  Monitor  Client,  go  to  the  directory  that  contains  the  executable 
DBmonitor  ( DBclient  directory)  and  start-up  the  executable. 

%  cd  DBclient 
%  DBmonitor 

The  Database  Monitor  Client  invokes  the  Track  Report  Manager(s)  in  a  continuous  loop  with  a 
default  sleep  of  15  seconds  between  each  invocation.  The  user  can  specify  the  sleep  period  by  provid¬ 
ing  a  numerical  parameter  to  the  DBmonitor  executable.  For  example,  if  the  user  wants  to  set  the 
sleep  period  to  30  seconds, 

%  DBmonitor  30 

3.7  DEMONSTRATION  SCRIPT 

The  following  is  a  condensed  demonstration  script  of  the  DOSE  application  as  described  earlier. 

To  start  up  the  first  Track  Report  Manager: 

%  cronus  login 
%  cd  trackrpt 
%  trm  /dbcreate=0 
%  trm  /interactive 

To  start  up  other  Track  Report  Managers  on  other  host  machines: 

%  cronus  login 
%  cd  trackrpt 
%  trm  /dbreplicate=0 
%  trm  /interactive 

After  all  the  Track  Report  Managers  are  running,  initialize  the  Track  Report  Manager  on  one  of 
the  host  machines  and  activate  the  graphics  display: 

%  cronus  tropic 

command:  on  {321}@host  InitializeDB 
command:  on  {321}@broadcast  SetMonitorFlag  /f 
command:  quit 
% 

Note:  @ broadcast  will  execute  the  SetMonitorFlag  operation  for  all  the  Track  Report  Managers. 
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To  start  up  the  Parser  Manager: 


%  cronus  login 
%  cd  parser 
%  parser  /dbcreate=320 
%  parser  /interactive 

After  the  Parser  Manager  is  running,  start  up  the  graphics  display  and  read  already  parsed  data  in 
trackfile: 

%  cronus  tropic 

command:  on  {320}@host  SetGraphicsFlag  /f 
command:  on  (320}@host  ReadTracks  trackfile 
command:  quit 

% 

To  start-up  the  Graphics  Map  Client: 

%  cd  /graphics 
%  graphics 

To  start-up  the  Database  Monitor  Client: 

%  cd  /DBclient 
%  DBmonitor 

3.8  DEMONSTRATION  CLEANUP 

The  following  steps  will  stop  the  services  of  the  Track  Report  Manager  and  Parser  Manager  and 
perform  the  necessary  cleanup.  If  the  graphics  displays  of  the  Track  Report  Managers  and  Parser 
Manager  are  on,  deactivate  the  graphics  displays  by  using  the  option  In  in  tropic  for  each  manager. 
Use  the  Cronus  command  stopservice  to  stop  the  services  of  the  managers.  Enter  each  of  the  manager 
directories  and  remove  the  old  object  databases  to  ensure  a  clean  start  for  the  next  demonstration. 

%  cronus  tropic 

command:  on  {321}@broadcast  SetMonitorFlag  In 
command:  on  {320}@host  SetGraphicsFlag  /n 
command:  quit 

%  cronus  stopservice  trm  ©host  (on  each  of  the  machines) 

%  cronus  stopservice  parser  (ghost 
%  cd  trackrpt 
%  rm  objectdb.321 
%  rm  objectdb.322 
%  cd  parser 
%  rm  objectdb.320 

The  Graphics  Map  Client  and  Database  Monitor  Client  are  not  Cronus  managers.  Thus,  they  are 
stopped  by  killing  their  process  identifications  (ids). 
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4.0  DEMONSTRATION  TESTBED  LAYOUT 


There  are  many  ways  in  which  the  DOSE  application  can  be  demonstrated.  The  method  chosen 
to  demonstrate  DOSE  will  depend  on  hardware  availability  and  the  emphasis  of  the  demonstration. 
The  following  describes  some  possible  methods  of  demonstrating  DOSE. 

4.1  MINIMUM  DEMONSTRATION  LAYOUT 

The  minimum  requirement  needed  to  demonstrate  the  DOSE  application  is  two  Sun  workstations. 
A  microterminal  connected  to  each  of  the  Sun  workstations  would  be  advantageous.  This  would  pro¬ 
vide  two  extra  monitors  for  the  demonstration.  A  suntools  package  will  provide  multiple  windows  on 
the  Sun  Monitor  and  eliminate  the  use  of  microterminals.  Within  the  suntools  package  is  a 
GraphicsTool  that  can  be  used  to  activate  graphics  display  of  the  managers  and  clients.  The  following 
is  a  possible  layout  to  demonstrate  DOSE: 

Sun  £1 

1.  Invoke  suntools  package. 

2.  Open  two  GraphicsTool  windows.  Use  one  window  for  the  Track  Report  Manager  and  the 
second  window  for  the  Parser  Manager. 

3.  Use  the  microterminal  connected  to  the  Sun  for  tropic  use  or  open  another  shell  window  in 
suntools  for  the  same  purpose. 

Sun  #2 

1.  Invoke  suntools  package. 

2.  Open  two  GraphicsTool  windows.  Use  one  window  for  another  Track  Report  Manager  (to  dem¬ 
onstrate  replication)  and  the  second  window  for  the  Graphics  Map  Client. 

3.  Use  the  microterminal  connected  to  the  Sun  for  activating  the  Database  Monitor  Client  or  open 
another  shell  window  in  suntools  for  the  same  purpose. 

4.2  RECOMMENDED  DEMONSTRATION  LAYOUT 

The  ideal  recommended  layout  to  demonstrate  the  DOSE  application  would  be  six  Sun  worksta¬ 
tions  with  a  microterminal  connected  to  each  workstation.  This  would  provide  a  full  graphical  view  of 
the  Track  Report  Manager,  Parser  Manager,  and  Graphics  Map  Client.  The  microterminals  can  be 
used  as  debug  tools  for  displaying  messages  from  the  managers  and  client.  Three  Sun  workstations 
would  provide  the  opportunity  to  fully  demonstrate  replication  with  three  Track  Report  Managers  run¬ 
ning  concurrently.  Load  sharing  could  be  demonstrated  with  two  Graphics  Map  Clients  invoking  any 
one  of  the  three  Track  Report  Managers.  Thus,  the  ideal  layout  would  be  the  following: 

three  Track  Report  Managers  on  three  different  host  machines, 

one  Parser  Manager  on  one  host  machine,  and 

two  Graphics  Map  Client  on  two  different  host  machines. 

Because  the  Database  Monitor  Client  has  no  graphics  display  of  its  own,  the  display  can  be  acti¬ 
vated  in  the  background  on  any  one  of  the  six  host  machines. 
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4.3  OTHER  LAYOUTS 

Many  other  possible  layouts  can  be  used  to  demonstrate  the  DOSE  application.  However,  the 
minimum  requirement  is  at  least  one  Track  Report  Manager  and  one  Parser  Manager.  The  Graphics 
Map  Client  and  Database  Monitor  Client  are  recommended  but  not  required  for  the  DOSE  demon¬ 
stration.  The  Track  Report  Manager’s  operations  can  be  invoked  through  tropic  rather  than  through 
the  clients. 

The  current  public  unclassified  distribution  of  the  DOSE  application  is  for  Sun  workstations  only. 
The  DOSE  application  is  not  limited  to  only  Sun  workstations.  NOSC  has  demonstrated  the  DOSE 
application  using  Sun  2,  Sun  3,  Sun  386i,  MicroVAX  II,  and  IBM  PC-AT. 
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